<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>distance_transform [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_regions.html">区域</a> / <a href="toc_regions_transformations.html">变换</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">distance_transform</span><span data-if="c" style="display:none;">distance_transform</span><span data-if="cpp" style="display:none;">DistanceTransform</span><span data-if="dotnet" style="display:none;">DistanceTransform</span><span data-if="python" style="display:none;">distance_transform</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">distance_transform</span><span data-if="c" style="display:none;">distance_transform</span><span data-if="cpp" style="display:none;">DistanceTransform</span><span data-if="dotnet" style="display:none;">DistanceTransform</span><span data-if="python" style="display:none;">distance_transform</span></code> — Compute the distance transformation of a region.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>distance_transform</b>(<a href="#Region"><i>区域</i></a> : <a href="#DistanceImage"><i>DistanceImage</i></a> : <a href="#Metric"><i>Metric</i></a>, <a href="#Foreground"><i>Foreground</i></a>, <a href="#Width"><i>Width</i></a>, <a href="#Height"><i>Height</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>distance_transform</b>(const Hobject <a href="#Region"><i>区域</i></a>, Hobject* <a href="#DistanceImage"><i>DistanceImage</i></a>, const char* <a href="#Metric"><i>Metric</i></a>, const char* <a href="#Foreground"><i>Foreground</i></a>, const Hlong <a href="#Width"><i>Width</i></a>, const Hlong <a href="#Height"><i>Height</i></a>)</code></p>
<p>
<code>Herror <b>T_distance_transform</b>(const Hobject <a href="#Region"><i>区域</i></a>, Hobject* <a href="#DistanceImage"><i>DistanceImage</i></a>, const Htuple <a href="#Metric"><i>Metric</i></a>, const Htuple <a href="#Foreground"><i>Foreground</i></a>, const Htuple <a href="#Width"><i>Width</i></a>, const Htuple <a href="#Height"><i>Height</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>DistanceTransform</b>(const HObject&amp; <a href="#Region"><i>区域</i></a>, HObject* <a href="#DistanceImage"><i>DistanceImage</i></a>, const HTuple&amp; <a href="#Metric"><i>Metric</i></a>, const HTuple&amp; <a href="#Foreground"><i>Foreground</i></a>, const HTuple&amp; <a href="#Width"><i>Width</i></a>, const HTuple&amp; <a href="#Height"><i>Height</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HRegion.html">HRegion</a>::<b>DistanceTransform</b>(const HString&amp; <a href="#Metric"><i>Metric</i></a>, const HString&amp; <a href="#Foreground"><i>Foreground</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HRegion.html">HRegion</a>::<b>DistanceTransform</b>(const char* <a href="#Metric"><i>Metric</i></a>, const char* <a href="#Foreground"><i>Foreground</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HRegion.html">HRegion</a>::<b>DistanceTransform</b>(const wchar_t* <a href="#Metric"><i>Metric</i></a>, const wchar_t* <a href="#Foreground"><i>Foreground</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>DistanceTransform</b>(<a href="HObject.html">HObject</a> <a href="#Region"><i>区域</i></a>, out <a href="HObject.html">HObject</a> <a href="#DistanceImage"><i>distanceImage</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Metric"><i>metric</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Foreground"><i>foreground</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Width"><i>width</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Height"><i>height</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HRegion.html">HRegion</a>.<b>DistanceTransform</b>(string <a href="#Metric"><i>metric</i></a>, string <a href="#Foreground"><i>foreground</i></a>, int <a href="#Width"><i>width</i></a>, int <a href="#Height"><i>height</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>distance_transform</b>(<a href="#Region"><i>区域</i></a>: HObject, <a href="#Metric"><i>metric</i></a>: str, <a href="#Foreground"><i>foreground</i></a>: str, <a href="#Width"><i>width</i></a>: int, <a href="#Height"><i>height</i></a>: int) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">distance_transform</span><span data-if="c" style="display:none">distance_transform</span><span data-if="cpp" style="display:none">DistanceTransform</span><span data-if="com" style="display:none">DistanceTransform</span><span data-if="dotnet" style="display:none">DistanceTransform</span><span data-if="python" style="display:none">distance_transform</span></code> computes for every point of the input
region <a href="#Region"><i><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></i></a> (or its complement, respectively) the
distance of the point to the border of the region.  The parameter
<a href="#Foreground"><i><code><span data-if="hdevelop" style="display:inline">Foreground</span><span data-if="c" style="display:none">Foreground</span><span data-if="cpp" style="display:none">Foreground</span><span data-if="com" style="display:none">Foreground</span><span data-if="dotnet" style="display:none">foreground</span><span data-if="python" style="display:none">foreground</span></code></i></a> determines whether the distances are calculated
for all points within the region (<a href="#Foreground"><i><code><span data-if="hdevelop" style="display:inline">Foreground</span><span data-if="c" style="display:none">Foreground</span><span data-if="cpp" style="display:none">Foreground</span><span data-if="com" style="display:none">Foreground</span><span data-if="dotnet" style="display:none">foreground</span><span data-if="python" style="display:none">foreground</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i>) or for all points outside the region
(<a href="#Foreground"><i><code><span data-if="hdevelop" style="display:inline">Foreground</span><span data-if="c" style="display:none">Foreground</span><span data-if="cpp" style="display:none">Foreground</span><span data-if="com" style="display:none">Foreground</span><span data-if="dotnet" style="display:none">foreground</span><span data-if="python" style="display:none">foreground</span></code></i></a> = <i><span data-if="hdevelop" style="display:inline">'false'</span><span data-if="c" style="display:none">"false"</span><span data-if="cpp" style="display:none">"false"</span><span data-if="com" style="display:none">"false"</span><span data-if="dotnet" style="display:none">"false"</span><span data-if="python" style="display:none">"false"</span></i>).  The distance is computed
for every point of the output image <a href="#DistanceImage"><i><code><span data-if="hdevelop" style="display:inline">DistanceImage</span><span data-if="c" style="display:none">DistanceImage</span><span data-if="cpp" style="display:none">DistanceImage</span><span data-if="com" style="display:none">DistanceImage</span><span data-if="dotnet" style="display:none">distanceImage</span><span data-if="python" style="display:none">distance_image</span></code></i></a>, which
has the specified dimensions <a href="#Width"><i><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></i></a> and <a href="#Height"><i><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></i></a>.
The input region is always clipped to the extent of the output
image.  If it is important that the distances within the entire
region should be computed, the region should be moved (see
<a href="move_region.html"><code><span data-if="hdevelop" style="display:inline">move_region</span><span data-if="c" style="display:none">move_region</span><span data-if="cpp" style="display:none">MoveRegion</span><span data-if="com" style="display:none">MoveRegion</span><span data-if="dotnet" style="display:none">MoveRegion</span><span data-if="python" style="display:none">move_region</span></code></a>) so that it has only positive coordinates and
the width and height of the output image should be large enough to
contain the region.  The extent of the input region can be obtained
with <a href="smallest_rectangle1.html"><code><span data-if="hdevelop" style="display:inline">smallest_rectangle1</span><span data-if="c" style="display:none">smallest_rectangle1</span><span data-if="cpp" style="display:none">SmallestRectangle1</span><span data-if="com" style="display:none">SmallestRectangle1</span><span data-if="dotnet" style="display:none">SmallestRectangle1</span><span data-if="python" style="display:none">smallest_rectangle1</span></code></a>.
</p>
<p>The parameter <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> determines which metric is used for
the calculation of the distances.  If <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'city-block'</span><span data-if="c" style="display:none">"city-block"</span><span data-if="cpp" style="display:none">"city-block"</span><span data-if="com" style="display:none">"city-block"</span><span data-if="dotnet" style="display:none">"city-block"</span><span data-if="python" style="display:none">"city-block"</span></i>, the distance is calculated from the shortest
path from the point to the border of the region, where only
horizontal and vertical “movements” are allowed.  They are
weighted with a weight of 1.  If <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'chessboard'</span><span data-if="c" style="display:none">"chessboard"</span><span data-if="cpp" style="display:none">"chessboard"</span><span data-if="com" style="display:none">"chessboard"</span><span data-if="dotnet" style="display:none">"chessboard"</span><span data-if="python" style="display:none">"chessboard"</span></i>, the distance is calculated from the shortest
path to the border, where horizontal, vertical, and diagonal
“movements” are allowed.  They are weighted with a weight of 1.
If <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> = <i><span data-if="hdevelop" style="display:inline">'octagonal'</span><span data-if="c" style="display:none">"octagonal"</span><span data-if="cpp" style="display:none">"octagonal"</span><span data-if="com" style="display:none">"octagonal"</span><span data-if="dotnet" style="display:none">"octagonal"</span><span data-if="python" style="display:none">"octagonal"</span></i>, a combination of these
approaches is used, which leads to diagonal paths receiving a higher
weight.  If <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> = <i><span data-if="hdevelop" style="display:inline">'chamfer-3-4'</span><span data-if="c" style="display:none">"chamfer-3-4"</span><span data-if="cpp" style="display:none">"chamfer-3-4"</span><span data-if="com" style="display:none">"chamfer-3-4"</span><span data-if="dotnet" style="display:none">"chamfer-3-4"</span><span data-if="python" style="display:none">"chamfer-3-4"</span></i>, horizontal and
vertical movements are weighted with a weight of 3, while diagonal
movements are weighted with a weight of 4.  To normalize the
distances, the resulting distance image is divided by 3.  Since this
normalization step takes some time, and one usually is interested in
the relative distances of the points, the normalization can be
suppressed with <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'chamfer-3-4-unnormalized'</span><span data-if="c" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="cpp" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="com" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="dotnet" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="python" style="display:none">"chamfer-3-4-unnormalized"</span></i>.  Finally, if <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'euclidean'</span><span data-if="c" style="display:none">"euclidean"</span><span data-if="cpp" style="display:none">"euclidean"</span><span data-if="com" style="display:none">"euclidean"</span><span data-if="dotnet" style="display:none">"euclidean"</span><span data-if="python" style="display:none">"euclidean"</span></i>, the computed distance is approximately
Euclidean.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Region" class="parname"><b><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></b> (input_object)  </span><span>region(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject</span></span>
</div>
<p class="pardesc">Region for which the distance to the border is
computed.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="DistanceImage" class="parname"><b><code><span data-if="hdevelop" style="display:inline">DistanceImage</span><span data-if="c" style="display:none">DistanceImage</span><span data-if="cpp" style="display:none">DistanceImage</span><span data-if="com" style="display:none">DistanceImage</span><span data-if="dotnet" style="display:none">distanceImage</span><span data-if="python" style="display:none">distance_image</span></code></b> (output_object)  </span><span>image <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject *</span> (int4)</span>
</div>
<p class="pardesc">Image containing the distance information.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Metric" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Type of metric to be used for the distance
transformation.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'city-block'</span>
    <span data-if="c" style="display:none">"city-block"</span>
    <span data-if="cpp" style="display:none">"city-block"</span>
    <span data-if="com" style="display:none">"city-block"</span>
    <span data-if="dotnet" style="display:none">"city-block"</span>
    <span data-if="python" style="display:none">"city-block"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'chamfer-3-4'</span><span data-if="c" style="display:none">"chamfer-3-4"</span><span data-if="cpp" style="display:none">"chamfer-3-4"</span><span data-if="com" style="display:none">"chamfer-3-4"</span><span data-if="dotnet" style="display:none">"chamfer-3-4"</span><span data-if="python" style="display:none">"chamfer-3-4"</span>, <span data-if="hdevelop" style="display:inline">'chamfer-3-4-unnormalized'</span><span data-if="c" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="cpp" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="com" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="dotnet" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="python" style="display:none">"chamfer-3-4-unnormalized"</span>, <span data-if="hdevelop" style="display:inline">'chessboard'</span><span data-if="c" style="display:none">"chessboard"</span><span data-if="cpp" style="display:none">"chessboard"</span><span data-if="com" style="display:none">"chessboard"</span><span data-if="dotnet" style="display:none">"chessboard"</span><span data-if="python" style="display:none">"chessboard"</span>, <span data-if="hdevelop" style="display:inline">'city-block'</span><span data-if="c" style="display:none">"city-block"</span><span data-if="cpp" style="display:none">"city-block"</span><span data-if="com" style="display:none">"city-block"</span><span data-if="dotnet" style="display:none">"city-block"</span><span data-if="python" style="display:none">"city-block"</span>, <span data-if="hdevelop" style="display:inline">'euclidean'</span><span data-if="c" style="display:none">"euclidean"</span><span data-if="cpp" style="display:none">"euclidean"</span><span data-if="com" style="display:none">"euclidean"</span><span data-if="dotnet" style="display:none">"euclidean"</span><span data-if="python" style="display:none">"euclidean"</span>, <span data-if="hdevelop" style="display:inline">'octagonal'</span><span data-if="c" style="display:none">"octagonal"</span><span data-if="cpp" style="display:none">"octagonal"</span><span data-if="com" style="display:none">"octagonal"</span><span data-if="dotnet" style="display:none">"octagonal"</span><span data-if="python" style="display:none">"octagonal"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Foreground" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Foreground</span><span data-if="c" style="display:none">Foreground</span><span data-if="cpp" style="display:none">Foreground</span><span data-if="com" style="display:none">Foreground</span><span data-if="dotnet" style="display:none">foreground</span><span data-if="python" style="display:none">foreground</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Compute the distance for pixels
inside (<i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i>) or outside
(<i><span data-if="hdevelop" style="display:inline">'false'</span><span data-if="c" style="display:none">"false"</span><span data-if="cpp" style="display:none">"false"</span><span data-if="com" style="display:none">"false"</span><span data-if="dotnet" style="display:none">"false"</span><span data-if="python" style="display:none">"false"</span></i>) the input region.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'true'</span>
    <span data-if="c" style="display:none">"true"</span>
    <span data-if="cpp" style="display:none">"true"</span>
    <span data-if="com" style="display:none">"true"</span>
    <span data-if="dotnet" style="display:none">"true"</span>
    <span data-if="python" style="display:none">"true"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'false'</span><span data-if="c" style="display:none">"false"</span><span data-if="cpp" style="display:none">"false"</span><span data-if="com" style="display:none">"false"</span><span data-if="dotnet" style="display:none">"false"</span><span data-if="python" style="display:none">"false"</span>, <span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Width" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></b> (input_control)  </span><span>extent.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Width of the output image.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>640</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>160, 192, 320, 384, 640, 768</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">Width</span>
    <span data-if="c" style="display:none">Width</span>
    <span data-if="cpp" style="display:none">Width</span>
    <span data-if="com" style="display:none">Width</span>
    <span data-if="dotnet" style="display:none">width</span>
    <span data-if="python" style="display:none">width</span>
    </code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Height" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></b> (input_control)  </span><span>extent.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Height of the output image.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>480</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>120, 144, 240, 288, 480, 576</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">Height</span>
    <span data-if="c" style="display:none">Height</span>
    <span data-if="cpp" style="display:none">Height</span>
    <span data-if="com" style="display:none">Height</span>
    <span data-if="dotnet" style="display:none">height</span>
    <span data-if="python" style="display:none">height</span>
    </code></p>
</div>
<h2 id="sec_example_all">例程 (HDevelop)</h2>
<pre class="example">
* Step towards extracting the medial axis of a shape:
gen_rectangle1 (Rectangle1, 0, 0, 200, 400)
gen_rectangle1 (Rectangle2, 200, 0, 400, 200)
union2 (Rectangle1, Rectangle2, Shape)
distance_transform (Shape, DistanceImage, 'chessboard', 'true', 640, 480)
</pre>
<h2 id="sec_complexity">Complexity</h2>
<p>The runtime complexity is O(<a href="#Width"><i><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></i></a>*<a href="#Height"><i><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></i></a>).</p>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">distance_transform</span><span data-if="c" style="display:none">distance_transform</span><span data-if="cpp" style="display:none">DistanceTransform</span><span data-if="com" style="display:none">DistanceTransform</span><span data-if="dotnet" style="display:none">DistanceTransform</span><span data-if="python" style="display:none">distance_transform</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if all parameters are
correct.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="threshold.html"><span data-if="hdevelop" style="display:inline">threshold</span><span data-if="c" style="display:none">threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">Threshold</span><span data-if="python" style="display:none">threshold</span></a></code>, 
<code><a href="dyn_threshold.html"><span data-if="hdevelop" style="display:inline">dyn_threshold</span><span data-if="c" style="display:none">dyn_threshold</span><span data-if="cpp" style="display:none">DynThreshold</span><span data-if="com" style="display:none">DynThreshold</span><span data-if="dotnet" style="display:none">DynThreshold</span><span data-if="python" style="display:none">dyn_threshold</span></a></code>, 
<code><a href="regiongrowing.html"><span data-if="hdevelop" style="display:inline">regiongrowing</span><span data-if="c" style="display:none">regiongrowing</span><span data-if="cpp" style="display:none">Regiongrowing</span><span data-if="com" style="display:none">Regiongrowing</span><span data-if="dotnet" style="display:none">Regiongrowing</span><span data-if="python" style="display:none">regiongrowing</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="threshold.html"><span data-if="hdevelop" style="display:inline">threshold</span><span data-if="c" style="display:none">threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">Threshold</span><span data-if="python" style="display:none">threshold</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="closest_point_transform.html"><span data-if="hdevelop" style="display:inline">closest_point_transform</span><span data-if="c" style="display:none">closest_point_transform</span><span data-if="cpp" style="display:none">ClosestPointTransform</span><span data-if="com" style="display:none">ClosestPointTransform</span><span data-if="dotnet" style="display:none">ClosestPointTransform</span><span data-if="python" style="display:none">closest_point_transform</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="skeleton.html"><span data-if="hdevelop" style="display:inline">skeleton</span><span data-if="c" style="display:none">skeleton</span><span data-if="cpp" style="display:none">Skeleton</span><span data-if="com" style="display:none">Skeleton</span><span data-if="dotnet" style="display:none">Skeleton</span><span data-if="python" style="display:none">skeleton</span></a></code>
</p>
<h2 id="sec_references">References</h2>
<p>

P. Soille: “Morphological Image Analysis, Principles and
Applications”; Springer Verlag Berlin Heidelberg New York,
1999.
<br>
G. Borgefors: “Distance Transformations in Arbitrary Dimensions”;
Computer Vision, Graphics, and Image Processing, Vol. 27, pages
321--345, 1984.
<br>
P.E. Danielsson: “Euclidean Distance Mapping”; Computer Graphics
and Image Processing, Vol. 14, pages 227--248, 1980.
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
